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I, INTRODUCTION 


Within the Honeywell Level 66 system a priviledged program provides 
time sharing service to remote users. To effectively provide a wide array 
of services to a varied user load, the time sharing system (TSS) has two levels 
of ccoemen support: 1) executive service and 2) subsystem service. 

The TSS executive can be thought of as a subordinate, “Miniature operating 
system running within the constraints of the GCOS supervisor. It is impractical 
for a vast set of service programs to be concurrently resident in memory so 
only those more permanent, recurring and critical functions are contained in the 
executive, | 

The TSS subsystems are free standing units that provide more of the 
interactive support for the users. Ina sense, the various subsystems can be 
thought of as extensions to the core of services provided by the executive, The 
subsystems perform the necessary interface functions required to build text, edit 
files, submit jobs, examine output and manipulate file structures (to name a few 
features). | 

During the course of a user's entire session many subsystems are called 
on behalf of the user by the executive level detection of certain conditions, and 
other subsystems are called in response to user entered data or commands at 
the terminal. 

It is possible for a site to record system behavior on its statistic collection 
file (SCF), A particular type of SCF record is known as the TYPE-19 or TSS 
Instrumentation Record, The TYPE-19 record contains selected data gathered 
by the executive on behalf of each user, All users in the TSS environment have 
a working space maintained by the executive called the User Status Table (UST). 
As each user session proceeds and the various subsystems invoked for or by the 
user terminate, an optional site parameter setting may cause the selected UST 
fields to be written to the SCF file along with some executive data. The buffering 
of TYPE-19 records to the accounting file (SCF) is enabled by altering the contents 
of a cell (TSSAS) within the TSS executive communication region module (TSSA) to 


a 


a non-zero value. 


The TYPE-19 Analysis package is an assembly level program capable of ; 
gathering all the TSS TY PL-19 records together for processing. The output 
from the program's processing of SCF records can take several detailed forms 
as directed by various input parameters. The output from the program is | 
intended for use by those persons maintaining, Measuring, and enhancing the 
TSS executive and subsystems. The detailed nature of the reports makes the 
output more suited to site analysts rather than upper levels of management; 


however, the generalized reduction of information must be based on detailed data. 


II, EXECUTION PARAMETERS 


The TYP#H-19 Analysis package is a simple activity to run because all file 
handling can be defaulted to program control or user specified. The program 
accepts two files as inputs - 1) AT is the accounting tape(s) and 2) I* is the input 
option file. A primary work file (XD) is established by the JCL oar program to 
contain only the TYPE-19 records as they are separated from the remaining records 


on file AT, The JCL required to run the TYPE-19 analysis is as follows: 


$ SNUMB 99999 
$ IDENT SITE STANDARD, NAME 
$ LOWLOAD 
$ OBJECT 
BINARY OBJECT DECK 
$ DKEND | 
$ EXECUTE DUMP 
INPUT OPTIONS 
$ LIMITS | 50, 40K,, 50K 
- (>) $ FILE XD, X1R, 300L 
3) $ TAPE AT, AlD,, 99999,, ACCNT,, D&NSIT 
$ ENDJOB 


The two starred files (*) may be omitted in the JCL declarations and 
dynamically acquired by the program during its execution using the MME GEMORE 
facility. | 

Practically, the program is best run against a single day's accounting tape 
or portions of a daily tape. The volume of data over extended periods of time 


may be inordinately large to process ina single run. , 


The output products are generated in response to several input option 


selections, The possible input options that can be supplied by the user are 


shown below with their associated interpretation. As evidenced, all options 


with the exception of time values are expressed as threeecharacter strings, 


one per logical record. 


OPTION 
ALL 


SUB-ssss 


USE-uuu, , .uuu 


SUM 


PRO 


MEM 
LOD 
DEM 


MAP 


DISPLAY THE FORMATTED 
FIELDS FROM ALL RECORDS 
FOUND. 


DISPLAY INFORMATION FOR 

ONLY THOSE RECORDS CONTAINING 
THE SUBSYSTEM NAME ssss. (e.g. 
SUB*JOUT, SUB*NEWU, etc.) 


DISPLAY INFORMATION FOR ONLY 
THOSE RECORDS CONTAINING THE 
USER ID uuu...uuu. (e.g. USE 
ABC, US#=TRAINING ID) 


PROVIDE A SUMMARY, BY 
SUBSYSTEM, OF THE RECORDS 


DISPLAY A PROFILE OF EACH 
USER SESSION _ 


PLOT MEMORY UTILIZATION 
PLOT USER LOAD 
PLOT USER MEMORY DEMANDS 


DISPLAY THE MEMORY MAPPING ~ 
OF USER ID's AND SUBSYSTEMS 


—_ 


Ons 


Siete) 


WLE 


TMI 


TM2 


TMS 


TM4 


re OL SOC Wie Dare Gd A 


ma Bas iPad ial 


gs re Da Oa 


DISPLAY MEMORY UTILIZATION 


DATA 


DISPLAY SUBSYSTEM SIZE 
DISTRIBUTIONS 


DISPLAY RESPONSE TIME 
DISTRIBUTIONS 


DISPLAY AN ONGOING 'WORK 
LOAD FACTOR," 


SELECT INFORMATION FROM 
00.000 TO 06.000 


SELECT INFORMATION FROM 
06.000 TO 12, 000 


SELECT INFORMATION FROM 
12,000 TO 18.000 


SsHELECT INFORMATION FROM 
18,000 TO 24.000 


SELECT INFORMATION FROM TIME 
INTERVAL Tl TO T2 


SELECT INFORMATION STARTING 
WITH THE FIRST RECORD AND 
ENDING AT TT, TTT 


SELECT INFORMATION STARTING | 
WITH TT, TTT AND ENDING AT | 
THE LAST RECORD 


Il. OUTPUT DESCRIPTIONS 


The output products consist of three parts - 1) The input summarization portion 
2) the record summarization portion, and 3) the input directed portions, | | a 
The input options are scaNWed for validity and echoed to the printer. Any 
errors in syntax are displayed, Appendix A is a sample of the input option display. 

The items in Appendix B are produced for each run and are not selectable by 
an input option. There are three main topics addressed as part of the summary-_ 
l) elapsed time and counters, 2) userid's and stations present, and 3) the counts 
of each subsystem occurrence. Within the userid/station id portion any zero 
userid field is replaced by the ''**UNKNOWN**'' string. A zero userid can occur 
during logon of a user under certain conditions, | 

The combination of userid/station id is considered to be a unique identifier 
for a session. For those sites with fixed terminal identities (e.g. VIPS) the 
uniqueness of a session becomes a bit more clouded. 

The displays from Appendix C and beyond constitute examples of input directed 
output, | | 

Appendix C is a sample plot produced by the selection of the MEM option. 
The plot time span is sensitive to any user specified time values. Within any 
time span the plot increment for the y-axis is automatically scaled to produce a 
paged plot. The x-axis increment represents a 2K increase with each plot point . 
(e.g. 0, 2, 4,6, 8, 10, etc.) shown in the heading. The numbers between the dashes 
can be thought of as a tens value number, for each plot time shown along the 
y-axis, the memory utilization is represented by executive entries (E), available 
space holes (-), subsystems (S) and upper limit of memory (*), As more users 
are detected the size of the exec may expand to contain the UST's. No distinction 
is made for a graphed line to show where adjacent subsystems break, It is 
possible for IX subsystems and 1K BTOS buffers to not be represented as plot 
points, and that is usually reflected by spaces between the last entry and’ TSS's 
upper memory limit. A sample interpretation using times 13.148 and 13. 275 
Show an executive size of 22K and 24K respectively indicating an increase for UST. 
space occurred, The line for time 13.148 shows more available space than is 
available at 13,275, Each entry reflects either 1K subsystems or 1K BTOS buffers 


present- in the first line, 4K is not plotted and in the second line, 8K is not plotted. 


Appendix D is a sample plot produced by selecting the LOD option. All 

_ plots are sensitive to the time span and are automatically eeeecus In this plot — 

the x-axis increment of 1 means the header values peneeneut an increase of 5 for 
each numbered plot point (e.g. 0,5, 10, 15, 20 etc.). Within the plot the number — 
of users (#), maximum number of users(*), number of users waiting memory (W), 
and number of urgent users (U) is shown. Coincident plot points are not resolved | 
by using alternative plot characters, As an example, the plot line at 13,275 shows 
l user waiting memory, no urgent users, 12 current users, and a maximum 
number of users equal to 15, 

Appendix —& is a sample plot produced in response to the D&M option, This 
plot has a 2K x-axis increment and reflects the number of users waiting memory 
(U), the memory needed (K) and the maximum number of users (*), As an example, 
line 14,736 reflects l user waiting for 14K with 16 users maximum, 

Appendixes F and G are samples from the ALL/SUB/USE options Steatae the — 
chronological occurrence of each record. All fields within the record are split 
out beneath appropriate headings. For time related values the numbers are 
representing seconds. The numbers to the extreme right are record Sequence 


numbers, ‘The field headings, their parent UST cell, and meanings are shown 


below: 
STAT ID _ (station identifier) is obtained from LBUF 
TRM TYP (terminal type) is obtained from LBUF 
BAR/SS SIZE (subsystem base address and size) are obtained 


from . LSIZE 


#SWAPS WT IN (number of swapouts waiting input) is obtained 
} from ,LTCO 
#SWAPS WT OT (number of swapouts waiting output) is obtained 


trond 2 TC 


#TRO FAULTS (number of timer runout faults) is obtained 
from ,.LTCl 
#DISPS NO-INT (number of dispatches met interrupted) is obtained 


—_ 


from ,LTCl 


| #INPUT REQ's 

#TERM OUTPUT 
#FORCE SWAPS 
TOTAL# SWAPS 


#KEY[O0 DRLS 
NUMBER DRLS 


#EBM ADDS 
#BUFF READS 
#KEYIO CHAR/8 


#DISK I/O's 


#CHR/8 IN SS 


#DIO IN SS 


MAX # USRS 
CUR# USRS 
#URG USRS 


TOTAL PROC 


a 


(number of terminal input requests) is obtained 


from ,LTC2 


(number of terminal output transmissions) is 


obtained from , LTC2 


(number of forced swapouts) is obtained from 


~LTC3 


(number of swapouts, swapins, loads) is obtained 
from , LTC3 . 
(number key I/O derails) is obtained from , LTC4 


(total number of derails) is obtained from .LTC4 


(number of times extra buffer memory was added) 


is obtained from ,LTC5 


(number of buffer reads from swapped buffers) is 


obtained from ,LTC5 


(number of keyboard output characters divided by 


8) is obtained from . LST10 


(number of disk I/O's) is obtained from .LST10 


(number of keyboard output characters counted 
within this subsystem) is obtained using . LST10 


and . LKDSS 


(number of disk I/O's within this subsystem) is 


obtained using .LST10 and . LKDSS 
(maximum number of users) 
(current number of users) 


(number of urgent users) 


(total processor time used by user) is obtained from | 


ee ors is 


PROC IN SS 


IN MEM RDBLCK 
SWPING TIME 

IN MEM PROC Q 
SWAPOT TIME 
WT MEM NOFSWP 
WT MEM FSWP 
pee TIME 


CONTRL TIME 


(processor time used within this subsystem) 


(non-useful time spent in memory but roadblocked) 


is obtained from .LTMO 


(time spent swapping the subsystem) is obtained 


from .LTMI1 


(useful memory residence time when subsystem 


is waiting for the processor) is obtained from .LTM3 


(time subsystem is swapped out, not waiting for 


memory) is obtained from . LTM3 


(time spent waiting memory not after forced 


swap) is obtained from . LTM4 


(time spent waiting memory after forced swap) 


is obtained from .LTM5 


(accumulated response time) is obtained from 


» LTMRS 


(START TIME OF PROCESS USED AS WORKING 
TIMER) is obtained from . LTMWT 


Appendixes H and I illustrate how a sample output from the UTL option might 


appear. Each entry represents a step in time from which memory utilization 


data is extracted. Each line consists of entries which detail the following: 


lj) number of subsystems in memory 


2) the smallest, average and largest sizes for subsystems in memory 


3) the number of available space holes 


4) the largest amount of memory available 


5) the number of BTOS buffers present 


6) the values of memory used and available 


7) the percentage of memory used and available 


Appendixes J and K illustrate how a sample report using the MAP option 


might appear. For each record occurrence the memory entries are broken out 


to show which users are present and what they are involved with. An attempt 


is made to correlate the station id back to the userid and if a unique entry cannot 


be found the’ *NON-UNIQUE*"! string is inserted. The user's subsystem size and 


subsystem name are followed by the number of dispatches and an interpretation 


showing either .L. FLAG bits or BTOS usage. As an example, the entries 
for 12.946 at the bottom of page 443 (appendix J) show 7 users in memory with 
one user (LINE-ID = 4460) having a BTOS buffer in use. All but two users 

are running routines from the CMDLIB (CMDL) facility. The other two users 
are running a 24K RUN Y subsystem and an NIK EDTX subsystem. Of interest 
is the trends that can be seen from previous entries (e.g. userid L66VU on 

line 5200 had 3 dispatches between the record occurrences at 12.939 and 12.946. 

Appendixes L through O are sample reports generated from the SUM option. 
Hach report shows the summarized statistics for the single specified subsystem. 
For each headed value the highest value, lowest value, average value and total 
value are shown. All times are shown in seconds. 

Appendixes P, Q and R are samples using the PRO option. Each unique 
userid/station-id identified session is shown in terms of tlh subsystems used by 
that user. The headings for the columnar data represent the same data fields — 
used for earlier reports. For sessions where the userid and station-id reflect 
multiple sessions a blank line occurs between the TERM and NEW subsystem 
entries. After all subsystems have been listed for4user, the users session is 
summarized showing totals lines, low values, average values, and high values. 
When alluser sessions are listed, a summary for all users shows the total 
sessions, the low, average and high values for the number of subsystems the 
low, average, and high values for elapsed time and the total number of subsystems, 

Appendix S is a sample report that results from the SSS option that shows 
the distribution of subsystem sizes. The histogram-like display is a more 
finely detailed breakout than is used in TSSA. The occurrences, percent values 
and cummulative percentages are shown in integer values. 

Appendix T is a sample output from the RES option showing distributions 
of response times gathered from the records. Again, this is a more refined 
steve for times than is currently kept in TSSA. | 

Appendixes U and Y are examples showing the represention of a work load 
factor as requested by the WLF option. The work load factor (WLF) is a single 
expression that is listed as a number and in Bbctewl form. The fields within 
the Type-19 record that are sensitive indicators of TSS performance are grouped 
into a numeric expression and reduced toa single number expressing periods 
of utilization that require further examination. The factors used in the WLF 


computation are: 


% 


=memory available 

= total hole size 

= amount of memory needed 

= number users waiting memory 
number of subsystems in memory 
= maximum number of users 


= current number of users 


_ 6 | OQ WS 
\ 


= number of urgent users 


The WLF is then computed as follows: 
WLF = ((A-B)*E) / ((C/D)**(F-G)*H) 


IV. USAGE 

The Type-19 reports can be used by a person familiar with the operation 
of TSS to determine which conflicts between users and resources result in 
reduced TSS performance. 


Critical areas of TSS that may be affected by user loads include: 


maximum user load 
memory assigned to TSS 


rate at which users wait for memory 


frequency of urgent users appearing 
use of CMDLIB routines 
effects of memory acquisition and release 


amounts settable within TSS 


amounts of memory needed when users are 


found waiting memory | 


excessive swap activity 
impact of large BTOS requirements 
‘ clash between specific users and their unique 


applications 
trends in the way subsystems are utilized 
delays in bringing subsystems into memory 


ratio of productive work prior to timer runouts 
or interrupts 


amount of keyboard I/O 


od 


amount of subsystem disk I/O 


trends reflected in the average session 
subsystem size distributions 


subystem response time distributions 


An analyst has a wide number of cells in the executive communication 
region (TSSA) that can be altered to effect different results. It is impossible 
to issue many hard edicts regarding parameter tuning for a site. Each site 
workload is unique and global tuning recommendations are hard to arrive at. 
Once a site goes beyond the "allocation of TSS files, FMS modules in memory, 
use of SSA cache'! effort a continuous cycle of definition of objectives, measurement, 
analysis, alteration of values is required to spot the trends that make a site 


unique or the user whose presence introduces system perturbations. 


V. MAINTENANCE 


The analysis package is coded in GMAP using liberal EJ§ instructions. 
All I/O is performed using standard GFRC subroutine calls. All references 
to fields within records are made using assembly defined symbols. The format 


of the Type-19 record is shown in-Appendix W. 
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